


DX10 BASIC 



■••■ : ' :':'y- ■■:■:■ 




'■■■ ■'■•'■'-•'■■ ■:'**:■'■ '■•>.■•.■■'■ ■:•: :•■ 
'. : X': : : : :<'y : '-: : >:-:-.-.v: :-. 










■■-:*»* . *p : *5i .w ■: mm »* a « 



No. 2250376-9701 *E 
1 becembersiil^ 



5— <*SS««» 



mm^mmm mimmmmi M,/„ ,, , 'mm 

,■"'?'*'*<, >„.*,„ ma- ■*,:■ -^ flit 

MMT^WII i»tL_„™ flUMI 48ft , * - 



isswwisssssfcss 'mgmwmm^wJMffim mmmmmmm. mum 

lllllillll illlt flllllilllli;. '^i«illife. iiill 




© Texas Instruments Incorporated 1982, 1983 
All Rights Ruserved, Printed in U.S.A. 



The information and/or drawings set forth in this document and ail rights in and to inventions disclosed 
herein and patents which might be granted thereon disclosing or employing the materials, methods, 
techniques or apparatus described herein, are the exclusive property of Texas Instruments Incorporated. 



Object Installation Contents 



Contents 

Title Pa 8 e 

Section 1 -- Introduction 1-1 

Section 2 — Deleting Previous Versions of BASIC 2-1 

Section 3 -- Preparing for Installation 3-1 

Section 4 -- Completing the Installation 4-1 

Section 5 — Executing BASIC 5-1 



+ + 

1 1 

1 READ THIS DOCUMENT BEFORE ATTEMPTING TO USE THIS OBJECT KIT. 1 

f IT DESCRIBES THE DX10 BASIC OBJECT INSTALLATION MEDIA, PART f 

1 NUMBERS 2250336-1601 AND 2250336-1602. YOU SHOULD ALSO READ 1 

1 THE PRODUCT RELEASE INFORMATION, PART NUMBER 22399 38-9901, 1 

1 PRIOR TO INSTALLATION. 1 

1 1 

1 TEXAS INSTRUMENTS ASSUMES NO RESPONSIBILITY FOR MODIFICATIONS 1 
1 MADE TO THIS OBJECT KIT. 1 

f 1 

+ — - + 



2250376-9701 iii/iv 



Object Installation Introduction 



Section 1 
Introduct ion 



1.1 GENERAL INFORMATION 

This document describes the procedures for installing the DX10 
BASIG(*) Interpreter, Version 4.1.0. 

Be sure to copy and/or write protect this master. For copy 
procedures, refer to the DX10 Operat ing System Operat ions Guide , 
Volume II , part number 946250-9702. 

All SCI commands in the this document appear in abbreviated form. 
You can enter commands as shown or enter them in long form by 
entering the command name and responding to the prompts that 
appear at the interactive terminal. For a discussion of the 
abbreviated command form, refer to the DX10 Operat ing System 
Operations Guide, Volume II, part number 946250-9702. 



1.2 MEDIA DEFINITION 

Object media shipments are made on one of three formats: 

* Disk — A DS10, CD1400, DS80, DS300, or 8-inch double- 
sided double-density diskette 

* Magnet ic Tape -- An 800- or 1600-bpi magnetic tape reel 
or 1600-bpi magnetic tape cartridge 

* Add-On — A DS80, DS300 or CD1400 disk pack that 
contains the object and one or more other products on 
the same disk pack 

The object files should be accessible by a synonym or synonyms. 
Section 3 describes the procedures for preparing the object media 
for this type of access. 

(*) BASIC is a registered trademark of the trustees of Dartmouth 
College, Hanover, New Hampshire. 
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1.3 INSTALLATION PROCEDURES 

The object media contains files and batch streams to perform 
these functions: 

* Install the new BASIC interpreter In a program file 

* Verify the Installation 



1.4 SYSTEM REQUIREMENTS 

To install the BASIC interpreter, you need to have a DX10 system, 
version 3.5 or later, and a system disk with the standard 
development utilities. 
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Section 2 
Deleting Previous Versions of BASIC 

Perform the steps outlined in this section if you desire to 
delete the previous version of BASIC from the program file 
,S$SDS$ on the system disk. If you want to retain the older 
version of BASIC, you must modify the procedure in the file 
. S$PROC. BASIC and copy it to another procedure file, because the 
Installation batch stream replaces the file . S$PROC . BASIC. 

To delete BASIC, perform these steps: 

1. Assign the synonym DSC to the system disk using the 
command : 

AS S=DSC, V=<volume name) 

where : 

<volume name) is the name of the system disk. 

2. Delete the BASIC procedure using the command: 

DP P=DSC.S$SDS$, PN0I=08B 

3. Delete the BASIC task using the command: 

DT P=DSC.S$SDS$, TNOI=08B 

4. Delete the BASIC SCI PROC using the command: 

DF P=DSC.S$PROC. BASIC 

After you enter the above commands, the previous 
version of BASIC is deleted from the system. 
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Section 3 
Preparing for Installation 



3.1 INTRODUCTION 

Before executing the installation instructions, you must prepare 
the object files so that the batch stream can access them. This 
section contains the instructions for preparing the files based 
on the media on which the object is received. 



3.2 DISK MEDIA 

When the. object is received on disk, load the object disk in an 
available disk drive and install the object disk using the 
command : 

IV U=DSxx, V-DXBOBJ 

where : 

DSxx is the device name of the disk drive 

where you loaded the object disk (such as DS01). 

Proceed to Section 4 for instructions on completing the 
installat ion. 
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3.3 MAGNETIC TAPE FORMAT 

When the object ships on magnetic tape reel or cartridge, you 
must transfer the object files to a disk volume before beginning 
the installation process. Perform these steps to move tape files 
to disk: 

1. Create a directory on the target disk by entering the 
command : 

CFDIR P=<volume nam e> . DXBOBJ , ME-10 

where : 

<volume name) is the name of the 
disk volume. 

2. Assign the DXBOBJ synonym to the directory by entering 
the command : 

AS S-DXBOBJ, V=<volume name>. DXBOBJ 

3. Load the tape or cartridge on an available drive. 

4. Restore the tape or cartridge to the directory by 
entering the command: 

RD S=MTxx, D=DXBOBJ, L». LISTING 

where : 

MTxx is the drive where you loaded the tape 
or cartridge. 

The file .LISTING contains a listing of the directory 
restored from the tape or cartridge. You can print the 
file by entering the Print File (PF) command or display 
it by entering the Show File (SF) command. 

5. Remove the tape or cartridge from the device drive 
after the restore directory operation completes. 
Proceed to Section 4 for instructions on completing the 
installation. 
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3.4 ADD-ON PACKAGE 

When you receive the object as an add-on package, perform these 
steps to prepare for installation: 

1. Load the add-on disk in an available disk drive and 
determine the volume name of the add-on disk as 
follows: 

SVS D=DSxx 

where : 

DSxx is the number of the disk drive where you 
loaded the add-on disk. 

2. Install the add-on disk by entering the command: 

IV U™DSxx, V=<volume name) 
where : 

<volume name) is the name of the add-on 
disk volume. 

3. Assign the DXBOBJ synonym to the directory <volume 
name>.DXBOBJ .on the add-on disk by entering the 
command : 

AS S=DXBOBJ, V=<volume name>. DXBOBJ 

Proceed to Section 4 for instructions on completing the 
installat ion. 
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Section 4 
Completing the Installation 



4.1 INTRODUCTION 

This section describes how to complete the installation of BASIC. 
You can access the BASIC object files by the name DXBOBJ. 



4.2 INSTALLING THE OBJECT 

Perform these steps to complete the installation from disk. 

1. Assign the synonym DSC to the system disk using the 
command : 

AS S=DSC, V=<volume name> 
where : 

(volume name) is the name of the installed 
system disk. 

2. Execute the installation batch stream using the 
command : 

XB I=DXBOBJ. INSTALL, L=.INSTLST 

The batch stream normally takes about three to five 
minutes to complete. During this time, you can monitor 
batch stream execution by issuing a WAIT or SBS 
command. When the batch stream completes successfully, 
the following message appears: 

DX10 BASIC INSTALLATION COMPLETE — ERRORS 



4.3 CHECKING THE BATCH STREAM LISTING 

The output generated by the batch stream goes to the listing file 
.INSTLST. When the batch stream has completed execution, you can 
examine this file by entering the Show File (SF) or Print File 
(PF) command to be sure that BASIC is properly installed. 
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When the batch stream completes successfully, the elements of 
BASIC are installed as follows: 

* The program file DSC . S$BASIC. PROG contains TI BASIC 

* The relative record file DSC . S$BASIC. OV400 contains the 
BASIC overlays 

* The directory DSC.S$BASUB contains the Keyed File 
Package (KFP) and sort routines 

* The .S$PROC directory contains a new procedure named 
BASIC 

You can confirm the success of the installation as follows: 

1. Enter the List Directory (LD) command to list the 
contents of the BASIC program file. 

LD P=DSC.S$BASIC 

The DSC.S$BASIC directory should contain a relative 
record file and a program file, as follows: 

OV400 (Relative record file) 

PROG (Program file) 

2. Enter the LD command again to list the KFP and sort 
subrout ines : 

LD P=DSC.S$BASUB 

The DSC.S$BASUB directory should contain the following 
eleven program files: 

BLDBUF 
KFCLOS 
KFCREA 

KFDELR 

KFGET 

KFINIT 

KFOPEN 

KFPUT 

KFREAD 

KFWRIT 

SORT 

3. You can delete the synonym DSC, if desired, using the 
Assign Synonym (AS) command as follows: 

AS S=DSC, V-"" 
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Section 5 
Executing BASIC 



To execute BASIC, enter the BASIC command and respond to the 
prompts as follows: 

EXECUTE BASIC 

WORKSPACE SIZE(KB): 32 
NUMBER OF OVERLAY BUFFERS: 8 
WORK FILE VOLUME NAME: 
INITIAL PROGRAM NAME: 

MODE (F,B): FOREGROUND 

BASIC is now installed and ready for use. Refer to the TI_ BASIC 
Reference Manual , part number 2308 769-9 701, for details on 
program development and execution. 



2250376-9701 5-1/5-2 



